home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / READLINE.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  43 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _ReadLine( nHandle, nLength ) --> cString
  8.  
  9. PARAMETERS:
  10.  
  11. nHandle   : file handle of previously opened file
  12. nLength   : Maximum line length to read (default 1024)
  13.  
  14. SHORT:
  15.  
  16. Read a line of text from an ASCII file.
  17.  
  18. DESCRIPTION:
  19.  
  20. _ReadLine() reads lines of text from a previously opened DOS text file.
  21.  
  22. nLength specifies the maximum line length to read.  If any line in the
  23. file exceeds this length, the remaining characters are read in in the
  24. next line.
  25.  
  26. NOTE:
  27.  
  28. See also _FEOF()
  29.  
  30. EXAMPLE:
  31.  
  32. #include "fileio.ch"
  33. handle = fopen('INPUT.TXT,FO_READ)
  34.  
  35. while !_FEof(handle)
  36.     This_Line = _ReadLine(handle)
  37. end
  38.  
  39. Result:  Each line of the text file is read into the This_Line variable until
  40. all lines have been read.
  41.  
  42. ******************************************************************************/
  43.